home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
remote
/
scanv_2a.zip
/
SCANVERT.DOC
< prev
next >
Wrap
Text File
|
1993-04-28
|
6KB
|
132 lines
Sysop Information for
SCANVERT.EXE
Legal Stuff:
I have no interest in making a buck for something that I did more
to practice my Turbo Pascal programming (it's been years since I have
done any TP programs), than anything else. So while I keep the source
codes and the rights to this software, the executable file is released
to the public domain. In no event shall I be held responsible for any
loses or damages resulting from the use of this utility. It works at
various test sites, and if you have doubts then you should not use it.
History:
This utility was done at the request of a few RA sysops that
complained that there was not a decent archive converter for RA 2.00's
Scan set up line. So I undertook the task of creating this little
program. While RA can unarc and scan uploads on it's own and tell you
if the archive is good, by checking the returned errorlevels, it can
not convert the files to a different archive type, hence this utility
comes in. Now, in version 2, I have invested some 30 programming and
testing hours in the quest to make it solid, idiot proof, and
versatile, while trying to accommodate the many requests for features.
Setup:
Make sure that the RA environmental variable is set. It must
point to the main RA directory, ie.: SET RA=D:\RA. Scanvert will not
run if the RA variable is not set.
In RACONFIG, under OPTION|FILES|UPLOAD SCAN enter the following
on the command line for the scan utility:
c:\ra\scanvert.exe @ CON/NOCON DIZ/NODIZ MSGBASENUMBER BBSAD_FILE *M
(This is my actual command line:
d:\ra\scanvert.exe @ CON DIZ 3 c:\banner.txt)
The path must be edited to reflect the actual location of your
copy of SCANVERT.EXE, and it can reside anywhere you wish.
The '@'is the first parameter and is translated by RA to the full
path and filename of the file to process.
The second parameter determines wether SCANVERT will convert the
file being processed to the format specified in the FILES.RA set up
for the upload location where the file resides. Scanvert will get all
compression and decompression info from the OPTION|FILES|ARCHIVERS
section in RACONFIG. Below is my setup. I recommend you use the same
ones, as they have been tested here. However, should you find a better
set up for any archiver, please let me know. Scanvert is limited by
RA's maximum of 10 archivers. You must still set the decompression
portion of all archivers in the RACONFIG, weather you convert them or
not, otherwise, Scanvert will not find the info it needs to decompress
and test the files.
EXT Unpack Command Pack Command
ARJ ARJ.EXE x -y @ ARJ.EXE a -r -jm @
ZIP PKZIP.EXE -d -o @ PKUNZIP.EXE -rp -a -ex @
LZH LHA.EXE e /x1m1 @ LHA.EXE a /r2x1 @
PAK PAK.EXE e @ PAK.EXE a @
SDN PAK.EXE e @ PAK.EXE a @
ZOO ZOO.EXE e @ ZOO.EXE a @
ARC PKUNPAK.EXE @ PKPAK.EXE @
HYP HYPER.EXE -x @ HYPER.EXE -a @
DWC DWC.EXE e @ DWC.EXE az @
SQZ SQZ.EXE X @ SQZ.EXE A /SP2 @
If found, the GIFTEST.EXE program will automatically be used to
test GIF files. It is included in this archive as a courtesy. To
register, contact Dave Navarro.
Scan.exe from McAfee associates will be used for virus testing.
If you run under a network, remove scan.exe from the path and place in
the path Netscan.exe and SCANVERT will detect and use that instead.
The third parameter must be either DIZ or NODIZ. This determines
wether SCANVERT will add any file descriptions found in the file to
the RA filebase. Supported are FILE_ID.DIZ and DESC.SDN. Since these
files are in a 40 column format and authors sometimes encase the text
in a high ASCII box, I have tried to make this routine as smart as
possible. It will remove all characters that do not fall in the 32-126
ASCII range. Also, duplicate spaces are removed. The goal is to make a
description free of tabs, carriage returns, line feeds and high ASCII
characters and let RA properly display the description at runtime. Any
of those chracters removed by scanvert will interfere with the way RA
formats the description causing really ugly output.
MSGBASENUMBER is the netmail message board to post messages to
you to let you know of any activity. Must have a valid message base
number or 0 to disable. If enabled, SCANVERT will write a message to
the SYSOP informing him/her of any file uploaded, wether it passed
testing and the original and final filesizes. In any case, wether
message base logging is enabled or disabled, a log is kept by scanvert
in the main RA directory so the sysop has a more durable means of
keeping tack of transactions.
The last parameter is optional, and if present must point to the
BBS Ad file a lot of sysops like to put in archives or could be a text
file indicating the file has been virus scanned, etc.
The *M is EXTREMELY IMPORTANT!, as SCAN.EXE and some archivers
use lots of memory and problems including lost files could show up if
you forget to swap RA out of memory.
You must also set RA to take proper action if a file fails.
SCANVERT will not move or delete any files that fail. RA must take
care of that. If you set RA to move the files and neglect to make that
area you set in there, RA will try to move them and delete them
instead.
My thanks to Ernie Jillson (1:135/58) and Ariel Vera (1:135/316)
for their questions and encouragement and the all important testing.
Serge Sozonoff for his help and code to handle the Novell networks.
Turbo Power Software for their excellent swapping units.
MC Soft, Inc and John C. Parlin for their excellent JPDOOR units.
Questions and suggestions can be sent to:
Paul Schencke
1:135/340@fidonet or 1:135/58@fidonet
72066,2443@Compuserve.com